docs: align README/CLAUDE.md/docs-site with 74-tool surface + add Actions concept section#171
Merged
Conversation
…ions concept section Audit reconciled doc claims against the actual code surface (commands/, agents/, skills/, scripts/cdp-bridge/src/index.ts) and surfaced the Actions concept that was already implemented but not documented as its own family. Counts (everything now reads from a single 2026-05-18 audit of trackedTool calls): - MCP tools: was "70+ / 64 / 51 / 38" depending on page → 74 everywhere - Commands: was "16 / 13 / 8 listed" → 17 everywhere - Agents: 5 (unchanged, was correct) Outdated info fixed: - docs-site/architecture.mdx implementation table said iOS routes through agent-device CLI; reality since PR #164 / D1219 is rn-fast-runner. Per-platform dispatch table now matches CLAUDE.md. - tools/index.mdx labelled cdp_interact as deprecated; the source description in index.ts does not, and the tool is the preferred JS-level interaction primitive. - astro.config.mjs sidebar omitted the Actions page, doctor, list-learned-actions, and run-action; all added. New "Actions" concept content: - docs-site/actions/index.mdx expanded with Why-hybrid section, composition pattern (worked prologue example), measured impact (210x speedup data point), comparison vs pure-script / pure-LLM alternatives, full tool surface (4 MCP + 2 commands), and the artifact-first protocol. - README Actions block tightened to one paragraph + updated table linking to the deep doc. - CLAUDE.md gains a contributor-facing Actions section under Architecture so future sessions internalise the LLM+pragmatic hybrid rationale. - MCP Tools table across all three (README / CLAUDE.md / tools/index.mdx) regrouped to surface Actions as a 5th family alongside CDP / Device / Testing / Macro-Asserts. Files changed: README.md, CLAUDE.md, docs-site/astro.config.mjs, docs-site/src/content/docs/actions/index.mdx, docs-site/src/content/docs/architecture.mdx, docs-site/src/content/docs/tools/index.mdx Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Audited every doc against the actual code surface (
commands/,agents/,skills/,scripts/cdp-bridge/src/index.ts) and reconciled the inconsistencies. The biggest gap: Actions is a real, implemented concept (4 MCP tools + 2 slash commands + theexperience/engine) but lived only as a brief table on the docs-site. This PR surfaces it as a 5th tool family and adds the deep "why LLM + pragmatic actions" explanation the README and CLAUDE.md were missing.Inconsistencies fixed
trackedTool()calls)cdp_interactlabeldoctor,list-learned-actions,run-actionNew "Actions" concept content
docs-site/actions/index.mdxexpanded with:cdp_run_action,cdp_repair_action,cdp_record_test_save_as_action,cdp_record_test_*+/list-learned-actions+/run-actionrn-tester/rn-debuggeragents scan actions before composing newdevice_*primitivesREADME.mdActions block tightened to one paragraph + an updated quick-reference table linking out to the deep doc.CLAUDE.mdgains a contributor-facing Actions section under Architecture so future sessions internalise the LLM+pragmatic hybrid design rationale.Files changed
README.md— header counts, MCP Tools table (5 families), Actions blockCLAUDE.md— full command listing, refreshed MCP server section (74 tools, 5 families), new Actions sectiondocs-site/astro.config.mjs— description + schema.org counts, sidebar (Actions page + missing commands)docs-site/src/content/docs/actions/index.mdx— deep hybrid concept contentdocs-site/src/content/docs/architecture.mdx— iOS/Android dispatch split; 74-tool countdocs-site/src/content/docs/tools/index.mdx— 74 tools, 5 families, removedcdp_interactdeprecated mislabelTest plan
cd docs-site && npm run dev) — confirm sidebar shows Actions section, command pages render, Actions page reads cleanly top-to-bottomgrep -n "70+\|51 MCP\|64 tools\|38 tools\|16 commands\|13 commands" README.md CLAUDE.md docs-site/returns nothinggrep -oE "trackedTool\(\s*'[a-z_]+'" scripts/cdp-bridge/src/index.ts | wc -lshould equal 74Out of scope (intentionally)
docs-site/.../tools/cdp/into their own folders — would invalidate all existing links; labels and overview pages now describe the families correctly without the move.rn-setup/rn-feature-development/using-rn-dev-agent— those.mdxfiles don't exist yet; that's an authoring task, not an audit task.🤖 Generated with Claude Code